home *** CD-ROM | disk | FTP | other *** search
/ Aminet 6 / Aminet 6 - June 1995.iso / Aminet / game / think / Slider.lha / Slider / Slider.doc < prev    next >
Encoding:
Text File  |  1995-04-07  |  15.1 KB  |  365 lines

  1. $VER: Slider.doc 1.07 (02.04.95)
  2.  
  3. SLIDER - version 1.07
  4. 02-April-95
  5.  
  6. Copyright ©1995 Joseph Carlson, All Rights Reserved
  7.  
  8.    This software IS freely redistributable as long as no files in the archive
  9. are modified or deleted.  This program is SHAREWARE (sort of), if you use it
  10. and like it, you MUST send me email saying so.  That's all, that's it... No
  11. money, just gratitude.  Send email to internet: j.carlson10@genie.com or from
  12. GEnie: J.CARLSON10
  13.  
  14.  
  15.  
  16. == SYSTEM REQUIREMENTS ========================================================
  17.  
  18.    Requires Kickstart 2.0 or higher.
  19.  
  20.    Any Amiga from A500 to A4000.
  21.       · If your machine has WB3.0+, the program asks the system for the
  22.          video mode that most closely matches 640x480 64 colors (VGA
  23.          Productivity).  This results multiscan if available, or Euro72,
  24.          DblPAL, PAL hires-lace, etc...  On ECS machines, this may even use
  25.          your graphics card if available to Intuition.
  26.       · With WB2.x, or if 64 color hires mode is not available, a 16 color
  27.          hires-lace screen is opened in the default mode that the computer
  28.          was booted in (NTSC or PAL).
  29.  
  30.    For full speed and visual effect, I recommend use on AGA machines.
  31.  
  32.  
  33.  
  34. == PROGRAM DESCRIPTION ========================================================
  35.  
  36.    Slider is a puzzle similar to those little number slide puzzles we have all
  37. played with at one time or another.  This version features a nice high res
  38. marble background with embossed wood pieces.  The size of the puzzle is
  39. adjustable in width and height from 2x2 to 8x8.  It is AGA & ECS compatible.
  40.  
  41. The object is to move the pieces as quickly as possible until they are in
  42. numerical order.  You move pieces by pointing to the piece you want to
  43. move, and pressing the left mouse button.
  44.  
  45.  
  46. THIS ARCHIVE INCLUDES:
  47.  
  48.    README                     - BBS description file
  49.    Slider.info                - The drawer icon.
  50.  
  51.    Slider/Slider.doc          - This text and its icon.
  52.    Slider/Slider.doc.info
  53.  
  54.    Slider/Slider              - The game and its icon
  55.    Slider/Slider.info
  56.  
  57.    Slider/Slider_AGA.iff      - AGA graphics data
  58.    Slider/Slider_ECS.iff      - ECS graphics data
  59.    Slider/Slider.snd          - sound effects
  60.  
  61.  
  62.  
  63. == INSTALLATION ===============================================================
  64.  
  65.    This archive decompresses into its own drawer.  Just copy or move the
  66. drawer and its icon into whatever directory you want to keep it in (simple).
  67.  
  68.  
  69.  
  70. == PROGRAM USAGE ==============================================================
  71.  
  72. To run, just double-click its icon.  Slider will display a scoreboard, the
  73. puzzle, and some gadgets.  Clicking on the SHUFFLE gadget will reset the
  74. clock to 0 and shuffle the puzzle pieces.  Just select with the mouse which
  75. piece you want to slide and that piece will move (if it can).  The clock
  76. starts when the first piece is moved.  The clock will stop when the puzzle
  77. is back in numerical order.  Also your time and number of moves will be
  78. recorded in the previous scores display.
  79.  
  80.  
  81. -- THE SCORE DISPLAY ------------------
  82.  
  83. The large green display is the time elapsed (accurate to 1/10th of a
  84. second) with the smaller green numbers being the size of the puzzle and the
  85. number of moves made.
  86.  
  87. The red displays underneath the green ones indicate the last 5 scores for
  88. solving the current size puzzle.  (Sorry, it's not a high score table
  89. yet...)
  90.  
  91. As of version 1.04, a character is displayed to the left of the moves count
  92. to indicate what mode the game is in.  A "C" indicates the computer is solving
  93. or has solved the puzzle.  A "P" indicates the game is paused.
  94.  
  95.  
  96. -- THE GADGETS ------------------------
  97.  
  98. There are 5 gadgets above the score display.  Keyboard shortcuts are shown
  99. in "quotes".  They are:
  100.  
  101.    QUIT "Q"- Quits the game. :)
  102.  
  103.    CONFIG "C"- Opens the config window for adjusting game parameters. (See
  104. THE CONFIG WINDOW below.)
  105.  
  106.    PAUSE "P"- Stops the clock until another piece is moved or PAUSE is clicked
  107. again.
  108.  
  109.    SOLVE "S"- Signals the computer to solve the puzzle for you!  (Clicking it
  110. again will put the game in PAUSE mode so you can finish it.)
  111.  
  112.    SHUFFLE "<spacebar>" - Shuffles the pieces around and resets the clock to 0:00.0.
  113. The clock starts when you move your first piece.  The larger the puzzle,
  114. the longer this takes.
  115.  
  116.    INVISIBLE DRAG BAR - You can't see it, but the screen's drag bar is
  117. there.  Just try to drag the screen down, it works!
  118.  
  119.    INVISIBLE DEPTH GADGET - You can't see this either, but if you click in
  120. the upper-right corner of the screen, you will flip screens normally.
  121.  
  122.  
  123. -- THE CONFIG WINDOW ------------------
  124.  
  125.    This is a small window which allows you to customize the puzzle.  The
  126. gadget descriptions and keyboard short cuts are:
  127.  
  128.    PUZZLE SIZE "W" or "H" - You can select any combination of width and
  129. height for the number of puzzle pieces.
  130.  
  131.    VISIBLE SHUFFLE "V" - When checked, you get to watch the pieces get shuffled
  132. on the screen.  If not checked, the new puzzle will appear instantly when
  133. SHUFFLE is pressed.
  134.  
  135.    ALWAYS SOLVABLE "A" - This determines what method is used to shuffle the
  136. pieces.  If checked, the computer will start with a solved puzzle and then
  137. randomly move the pieces around.  The number of moves depends on the size
  138. of the puzzle.
  139. If not checked, the computer will start with an empty puzzle and drop
  140. pieces in random places in the puzzle.  This is very quick, but the
  141. resulting puzzle will not always be solvable.  (Thanks to Randy for this
  142. idea)
  143.  
  144.    HIGH TASK PRIORITY "P" - On an A500 things are a bit slugish as far as
  145. mouse movement is concerned...  When checked, this raises Slider's
  146. task priority to 50.  I only suggest using this on an A500,  it will
  147. actually slow things down on faster machines. If not checked, task priority
  148. is set to 0. (default)
  149.  
  150.    CUSTOM PICTURE / PICTURE SETTINGS - For future versions if people are
  151. interested in one.  -- Not implemented.
  152.  
  153.    SAVE "S"- saves current settings as tool types in Slider's icon
  154. (slider.info).  -- Not implemented.
  155.  
  156.    USE "U"- uses the current settings and remakes puzzle if size was change.
  157.  
  158.    CANCEL "C"- returns to puzzle, ignoring any new settings.
  159.  
  160.  
  161. -- THE KEYBOARD -----------------------
  162.  
  163.    "<ESC>" or "Q" Quits the game.  Shortcuts for gadgets are listed above.
  164. You can also move the puzzle pieces by using the cursor keys or numeric
  165. keypad keys.  This will move the piece that is on the side of the blank
  166. space that you point to.  (?)  For example, if you press UP, the piece up
  167. above the blank space will move.  A little confusing, but it really hurts
  168. to play this way.  Just use the mouse, I am not responsible for any hand
  169. injuries caused by anyone playing this game with the keyboard.
  170.  
  171.  
  172. -- THE BRAIN --------------------------
  173.  
  174.    If you select SOLVE, the computer will solve each piece in order until
  175. it reaches the bottom two rows.  It will then solve the last two rows
  176. simultaneously from left to right.  If the puzzle is unsolvable, the
  177. computer will beep when it has solved as much as it can, and the timer
  178. will just keep on going...  The fastest that computer is allowed to
  179. move is once every Intuitick (0.1 seconds).  Because the window doesn't get
  180. every intuitick message, and the computer pauses in between move sequences,
  181. it's time will be slower than 10 moves a second.  It's still faster than
  182. I've seen anyone play this, so I have no desire to speed it up.  (I
  183. wouldn't mind if it was even slower than this...)
  184.  
  185.  
  186.  
  187. == HINTS ======================================================================
  188.  
  189.    Just hold the mouse button down when moving pieces.  Your mouse button
  190. probably won't last long if you click it once every move.  It's about 1000
  191. moves to solve an 8x8 puzzle (I had to replace my left mouse button before
  192. I realized I should put this feature in.)
  193.  
  194.    If you get stuck on one piece, press SOLVE to see how the computer puts
  195. it in, then press SOLVE again to stop the computer and finish the puzzle
  196. yourself.  Read "THE BRAIN" section to see what order the computer solves
  197. the puzzle in.
  198.  
  199.    If you activate another window to check on something else running on your
  200. Amiga, Slider will pause the clock and wait for you to you reactivate the
  201. Slider window.
  202.  
  203.  
  204.  
  205. == KNOWN BUGS: ================================================================
  206.  
  207.    None, anymore ;-).
  208.  
  209.    I try my hardest to make sure all my programs are completely bug free.
  210. I use an A4000 and nothing iritates me more than downloading a game that
  211. doesn't run on this machine.  I test all my software on the A4000 as well as
  212. on an Amiga 500, trying every combination of options possible, running other
  213. programs at the same time, and using up LOTS of run time.  I can solve these
  214. puzzles almost as fast as the computer now. If you find a bug, PLEASE let me
  215. know!!!  If I don't know about it, I can't fix it.  Quality is very important
  216. to me.
  217.  
  218.  
  219.  
  220. == HISTORY ====================================================================
  221.  
  222. Version 1.07   06-Apr-95
  223.    ·  V1.06 proved not to work with ECS and WB3.1...  Screen setup routine is
  224.          now completely rewritten.  It checks GfxBase directly for chip set
  225.          and default display mode.  With AGA chipset, Slider asks system for
  226.          best mode available (64 colors).  With non-AGA chipset, Slider opens
  227.          a hi-res lace screen in the mode the computer was booted in (NTSC or
  228.          PAL).  Should work with all Amigas 500-4000, WB 2.0-3.1, OCS/ECS/AGA
  229.          Chips.
  230.  
  231.       Thanks go to all those who reported problems and successes, and to those
  232.       who tested this version for me on their different Amigas so I could be
  233.       sure it worked for everyone before I released it.
  234.  
  235.  
  236. Version 1.06   31-Mar-95
  237.    ·  This time I really fixed the A3000 problem (at least with WB2.1)....
  238.       Thanks go to Mike Nelson for testing and quick bug reporting!
  239.  
  240. Version 1.05   26-Mar-95   (wish it was not released)
  241.    ·  Thought I fixed problem when running on an A3000, but I made it worse.
  242.       Seems OpenScreen() would open a Productivity screen in 4 colors even
  243.       though I specified 64!
  244.  
  245. Version 1.04   13-Jan-95
  246.    ·  Added Pause/Computer indicator (the P or C on the LED display).
  247.    ·  Added ability to move more than one piece at a time.  Now if you click on
  248.          any piece that is in the same row or column as the empty spot, all
  249.          the tiles in between will move.
  250.    ·  Touched up AGA graphics to give more depth to LED display and to smooth
  251.          marble background.
  252.    ·  Rewrote shuffle routine to be more thorough and efficient.
  253.    ·  Added version number into config window titlebar.
  254.    ·  Error messages now appear in requesters.
  255.  
  256. Version 1.03   29-Oct-94   (not released)
  257.    ·  Added internal loading routines for IFF files eliminating the requirement
  258.          for "iff.library".  This also eliminated any need for access to iff
  259.          files after gamescreen is loaded.
  260.    ·  Computer now stops trying when it cannot solve a puzzle.
  261.  
  262. Version 1.02   27-Oct-94   (not released)
  263.    ·  Added busy pointer/ghosted gadgets for when window was busy shuffling
  264.          tiles or during Config mode so that multiple gadget hits (like on
  265.          SHUFFLE) would have no effect.
  266.    ·  Now recognizes earlier Kickstarts and alerts you if your not using at
  267.          least WB 2.0
  268.  
  269. Version 1.01   30-Sep-94   (not released)
  270.    -  It is possible to flip screens, activating another window without
  271.       releasing the mouse button (ala QMouse).  Slider would therefore
  272.       not recieve the mouse SELECTUP message and let you move pieces
  273.       even though you were no longer holding the button down.
  274.  
  275. Version 1.00   9/9/94
  276.    -  First public release.
  277.  
  278.  
  279.  
  280. == ALSO FROM THE AUTHOR =======================================================
  281.  
  282.    QMousePrefs -  This program gives you a preferences window for
  283.                   adjusting any options for QMouse by Dan Babcock.
  284.                   Also includes icon for your WBStartup drawer so you
  285.                   don't have to modify s:User-Startup to use QMouse.
  286.  
  287.    CARNAGE - An addictive two player game in which you must seek out and
  288. kill your opponent with the nastiest weapon you can find.  This 2d split
  289. screen overhead scroller features high-res graphics, well thought out
  290. stereo sound, mazes, teleports, all kinds of weapons ranging from rifles to
  291. bazookas, and terrifying killer robots that seem to know your every move.
  292. Also features serial/modem link support for playing against a friend (or
  293. foe) who is only a phone call away.  And you can type messages to each
  294. other in real time so you can express your true feelings about having a
  295. grenade tossed at you.  Carnage is written by Randall Richards and Joseph
  296. Carlson.
  297.  
  298.  
  299.    CP-1 SEGA(TM) CONTROL PAD ADAPTER - Tired of the old joysticks that
  300. only have one button?  Having trouble finding an old standard joystick?  Well
  301. this little adapter allows you to use any joystick made for the Sega Genesis
  302. with your Amiga.  Sega Genesis Controllers are easy to find (any Toys 'R Us)
  303. and inexpensive (about $13 for the SEGA brand).  The joypad and trigger (B)
  304. button will work for any game, and we have released a shared library for other
  305. programmers to utilize ALL the other buttons in their games.  Future games we
  306. release will use the extra buttons (Carnage registered version already does!).
  307. My friend Randy and I are currently using the adapter with SEGA infrared
  308. cordless controlpads on our Amigas.  Please contact me if you are interested
  309. in obtaining or supporting such a product.
  310.  
  311.  
  312.    CONTROLPAD LIBRARY:  What good is a control pad adapter without support?
  313. Well, with this simple shared library, game programmers will have an easy time
  314. incorporating those extra buttons into their games.  This library is freely
  315. distributable and allows programs to check the real time status of joystick
  316. or controlpad buttons, direction, and type with a simple and very fast library
  317. function call.  If you feel the need to make a game that uses more than one
  318. button, then this is for you!  The archive includes the library, docs, sample
  319. code, a controlpad/joystick/adapter test program, and ordering information
  320. for the CP-1 ControlPad Adapter.  The library reads joysticks just fine
  321. without the adapter, so you can still use the library even if you don't want
  322. to take advantage of the extra buttons.
  323.  
  324.  
  325. -- COMING SOON ------------------------
  326.  
  327.  
  328.    READ - A fast text file reader which adapts to any screen mode and any
  329. fixed width font.  Fast (and fine) scrolling via mouse or cursor keys.
  330. Scrolls left and right as well as up and down.  (Just when you thought
  331. you've seen enough text readers...)  By Joseph Carlson.
  332.  
  333.  
  334.  
  335. == THE AUTHOR =================================================================
  336.  
  337.    Please send any comments to:
  338.  
  339.       Joe Carlson
  340.       3020 E Yorba Linda Blvd
  341.       Apt. E-22
  342.       Fullerton, CA  92631  USA
  343.  
  344.       EMAIL: INTERNET -> j.carlson10@genie.com
  345.                    or    xjcarlson@csu.fullerton.edu
  346.              GENIE    -> J.CARLSON10
  347.  
  348.  
  349.    I would appreciate any feedback you might have, such as suggestions or
  350. bug reports.
  351.  
  352.    Special thanks to Randy Richards, good friend for over 10 years.  The
  353. computer solving routines would've been a nightmare without your "queue.c"
  354. code.  Also to Dave Esposito for testing this on his A1200 and to Peter Olafson
  355. for the mention of Slider in Amigaworld!
  356.  
  357.  
  358. Commodore is dead (and it's about time...)
  359.  
  360.                                //
  361.          Long live the Amiga \X/ and whatever company gets the rights to it!
  362.  
  363.  
  364. ===============================================================================
  365.